home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 4.iso / hardware / rap / README < prev    next >
Encoding:
Text File  |  1994-08-02  |  3.4 KB  |  85 lines
  1.                                                                             
  2.            Roland RAP-10 Music Card Device Driver for Eisa Bus              
  3.          ---------------------------------------------------
  4.                                                                             
  5.     PURPOSE
  6.     -------
  7.     This directory contains a sample device driver for IRIX 5.2 EISA bus.
  8.     In particular, this device driver is used to demonstrate:
  9.     
  10.     - Writing a character device driver for EISA bus.
  11.     - How to obtain an Interrupt number (IRQ)
  12.     - How to allocate and program EISA DMA chipsets. 
  13.     - How to program Eisa Dma channels for hardware recognition.
  14.     - How to use EISA Dma chips to move data from/to a device.
  15.     - How to manage and use a circular buffers between kernel and
  16.       user's read/write calls.
  17.     - and many more ..
  18.     
  19.  
  20.     Driver Installation:
  21.     --------------------
  22.       You should have the following files:
  23.  
  24.       rap.c:    The driver source code.
  25.       rap.h:    The driver's header file.
  26.       record.c: The program to records a song.
  27.       play.c:   The program to Play a previously recorded song.
  28.       rapMap.c: Sample program to use mmap() to access the card.
  29.       Makefile: The 'make' file to compile everything.
  30.  
  31.       It is better to make a sub-directory for these files and 
  32.       copy them there. 
  33.        Copy your current unix to a safe place (ie. cp /unix /usr/unix.orig)
  34.        and compile the programs by typing:
  35.  
  36.          make all 
  37.  
  38.       Select an unused major number to assign for Rap card (refer
  39.       to your sys/major.h file). Once you have an unused major number,
  40.       (assuming the number you have is <major>) do the following to
  41.       install the driver: 
  42.  
  43.           Login as root and do:
  44.              mknod /dev/rap c <major> 0
  45.              cp rap.o /var/sysgen/boot    
  46.              cp rap.master /var/sysgen/master.d 
  47.              cp rap.sm  /var/sysgen/system
  48.              autoconfig -f -v
  49.              reboot
  50.  
  51.        If you do not have /var/sysgen, then try /usr/var/sysgen directory.
  52.  
  53.  
  54.     Recording and Playback of a song
  55.     --------------------------------- 
  56.     Connect a CD player to the Mic/Line connector using a standard
  57.     RCA connectors as follow: You need two cables, each with one 
  58.     RCA male connectors in one end and one RCA male connector on
  59.     another end. Use two RCA male-to-male connectros to connect
  60.     the two-connector ends of the cable together. Now, connect one
  61.     single-connector to Mic/Line of the Rap-10 board and another
  62.     one to the Headphone of the CD player. Start the CD (either
  63.     through the start button on CD player or from a separate
  64.     CD player program) and type "record <file_name>", where 
  65.     <file_name> is the name of the file in which the song will be
  66.     recorded. You can stop the recording by entering a Ctrl-C at
  67.     any time. You can hear the song while it is being recorded
  68.     by connecting a headphone to the Out connector of the Rap-10
  69.     card.
  70.  
  71.     To play back, connect a headphone to Out connector of the 
  72.     Rap-10 card. Then enter "play <file_name>".
  73.  
  74.  
  75.     TECHNICAL REFERENCES:
  76.     ---------------------
  77.     Roland RAP-10 Technical Reference and Programmer's Guide, Ver. 1.1
  78.     IRIX Device Driver Programming Guide
  79.     IRIX Device Driver Reference Pages.
  80.     Intel 82357 Preliminary Reference, Section: 3.7.8 Mode Register (pp: 223)
  81.  
  82.     ---------------------------------------------------------
  83.      Copyright 1994, Silicon Graphics Inc., Mountain View, CA.           
  84.     ---------------------------------------------------------
  85.